home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / lib / c / stdlib / atexit.man < prev    next >
Encoding:
Text File  |  1989-03-22  |  1.4 KB  |  42 lines
  1. ' Copyright 1989 Regents of the University of California
  2. ' Permission to use, copy, modify, and distribute this
  3. ' documentation for any purpose and without fee is hereby
  4. ' granted, provided that this notice appears in all copies.
  5. ' The University of California makes no representations about
  6. ' the suitability of this material for any purpose.  It is
  7. ' provided "as is" without express or implied warranty.
  8. ' 
  9. ' $Header: /sprite/src/lib/c/stdlib/RCS/atexit.man,v 1.1 89/01/05 18:00:22 ouster Exp $ SPRITE (Berkeley)
  10. ' 
  11. .so \*(]ltmac.sprite
  12. .HS atexit cmds
  13. .BS
  14. .SH NAME
  15. atexit \- Register procedure to be invoked before process exits
  16. .SH SYNOPSIS
  17. .nf
  18. \fB#include <stdlib.h>
  19.  
  20. \fBint
  21. atexit(\fIfunc\fB)\fR
  22. .SH ARGUMENTS
  23. .AP void *func() in
  24. Procedure to call just before process exits.
  25. .BE
  26.  
  27. .SH DESCRIPTION
  28. .PP
  29. \fBAtexit\fR may be used to register the procedure \fIfunc\fR, such
  30. that \fIfunc\fR will be invoked by the \fBexit\fR procedure before
  31. the process exits.  \fIFunc\fR will only be called if the \fBexit\fR
  32. procedure is invoked:  if the process terminates because of a signal,
  33. or if the process bypasses \fBexit\fR by calling \fB_exit\fR, then \fIfunc\fR
  34. will not be invoked.
  35. \fIFunc\fR takes no arguments and returns no result.
  36. .PP
  37. The normal return value from \fBatexit\fR is 0.  If the registration
  38. fails then a non-zero value is returned.
  39. .DE
  40. .SH KEYWORDS
  41. exit, handler, register
  42.